歌词迷API文档学习

一：学习目的

      因进来做一个Android MP3播放器项目，需要用到歌词本地同步和在线同步，本地不存在在通过WiFi或GPRS从网络上获取；

二：学习API的网址：

      http://api.geci.me/en/latest/index.html#indices-and-tables

三：学习前掌握的知识：

1）看的懂Json数据格式；

2）如果想深入了解此API要了解汉字和Unicode的转换！

四：学习内容

主要可以通过一下方式来获取歌词：

1)    根据歌曲名来获取歌词

2)    格局歌曲名和歌手名获取歌词

3)    根据歌曲编号获取歌曲URL

4)    根据专辑编号获取专辑封面URL

五：详细分析

：根据歌曲名来获取歌词

1）        请求地址：http://geci.me/api/lyric/:song

2）        返回歌词格式： json字符串

3）        请求方式是：get方式；

 Eg：查找“海阔天空”的歌词；url：http://geci.me/api/lyric/海阔天空

获取到的json数据格式如下：

{   "count": 15,    "code": 0,    "result":

这并非我们所找歌曲的歌词，而是在歌词迷库中存在的不同版本歌曲歌词的url；

从这里看有15个版本（坑爹啊）；

  {"aid": 1563419, "lrc": "http://s.geci.me/lrc/166/16685/1668536.lrc", "artist": "Beyond", "song": "\u6d77\u9614\u5929\u7a7a", "sid": 1668536}

Aid: 经多次测试，得到此编号指

Lrc:歌词的路径；

Artist：Beyond –歌手名字

Song: 海阔天空—歌曲名称；

Sid：是歌词编号；

1）        请求地址：http://geci.me/api/lyric/:song

2）        返回歌词格式： json字符串

3）        请求方式是：get方式；

Eg:查找黄秋生的“海宽天空”  http://geci.me/api/lyric/海阔天空/黄秋生

1） 请求地址：http://geci.me/api/cover/:album_id

2） 返回歌词格式： json字符串

3） 请求方式是：get方式；

Eg：

{"aid": 1563419, "lrc": "http://s.geci.me/lrc/166/16685/1668536.lrc", "artist": "Beyond", "song": "\u6d77\u9614\u5929\u7a7a", "sid": 1668536},

知道了以上信息可以通过http://s.geci.me/lrc/166/16685/1668536.lrc中1668536或sid获取歌词路径；

1）        请求地址：http://geci.me/api/cover/:album_id

2）        返回歌词格式： json字符串

3）        请求方式是：get方式；

以第一个版本为例：

六：学习收获

       初次学习关于歌词API，再加上官方给的文档没有详细的说明，学习起来很吃力。通过不断的测试对该API进行个人分析所得；做笔记供下次使用和有此需求的网友参考！